.TH E1432_CACHED_PARM_UPDATE 3 E1432
.SH NAME
e1432_cached_parm_update \- Update parameters cached by the host library
.IX e1432_cached_parm_update(3) 3
.SH SYNOPSIS
.cS
SHORTSIZ16 e1432_cached_parm_update(E1432ID hw, SHORTSIZ16 ID)
.cE
.SH DESCRIPTION
When reading data from an E1432 module using
\fIe1432_read_xxx_data\fR, the host library must know the values of
several E1432 parameters, such as blocksize.  Rather than query the
E1432 module each time the data transfer is done, the host library
saves (caches) the value of these parameters internally, and uses the
saved value when doing the data transfer.  This reduces the overhead
of the data transfer functions.  This function,
\fIe1432_cached_parm_update\fR, is what actually saves the parameter
values in the host library internal data structures.

\fIe1432_cached_parm_update\fR is normally called internally by
\fIe1432_init_measure\fR, and is therefore not normally needed by the
end user.  We provide it for use in special cases where it may be
useful.

An example of when this might be useful is if one host computer is
responsible for setting up E1432 measurement parameters and starting a
measurement, but a second computer is used to actually transfer the
E1432 data.  The second computer must use
\fIe1432_cached_parm_update\fR after the first computer sets up the
measurement, to update the internally cached parameters on the second
computer, so that the data transfer will work properly.

\fIhw\fR must be the result of a successful call to
\fIe1432_assign_channel_numbers\fR, and specifies the group of
hardware to talk to.

\fIID\fR is either the ID of a group of channels that was obtained with a
call to \fIe1432_create_channel_group\fR, or the ID of a single
channel.  Typically a group ID is used.

.SH "RESET VALUE"
Not applicable.
.SH "RETURN VALUE"
Return 0 if successful, a (negative) error number otherwise.
.SH "SEE ALSO"
.na
e1432_init_measure, e1432_read_float32_data, e1432_read_float64_data,
e1432_read_raw_data
.ad
